home *** CD-ROM | disk | FTP | other *** search
/ MACD 5 / MACD 5.bin / workbench / tools / czesc_1 / analyzer / analyzer.help < prev    next >
Text File  |  1991-12-22  |  11KB  |  319 lines
  1.         ß52ß
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                                CONTENTS
  13.  
  14.                          1. Introduction
  15.                          2. Conditions of Use
  16.                          3. Main Window Buttons
  17.                          4. Cursor Functions
  18.                          5. File access Window
  19.                          6. Trace setup Window
  20.                          7. Trace Order Window
  21.                          8. Search Window
  22.                          9. Memory Requirements
  23.                         10. Limitations
  24.                         11. Bugs
  25.  
  26.  
  27.       INTRODUCTION
  28.  
  29.    Analyzer is a logic analyzer without the data acquisation hardware.
  30.    It can be used in exactly the same way as a logic analyzer, but
  31.    with data files instead of real signals.
  32.    
  33.    It allows data stored in one or more files to be examined as
  34.    representations of electrical signals, either graphically or
  35.    numerically. Screendumps of the traces may also be produced.
  36.    
  37.    It will automatically adapt to run on either NTSC or PAL machines.
  38.    
  39.  
  40.       CONDITIONS OF USE
  41.  
  42.    The program 'Analyzer' (referred to below as 'the software')
  43.    is SHAREWARE. If you use this regularly, please send 120 French
  44.    Francs (or equivalent in local currency) to:
  45.    
  46.          Andrew Hackett
  47.          2, Rue des Champs
  48.          67210 Goxwiller
  49.          FRANCE
  50.  
  51.    Send the fee along with your name, address and version number of
  52.    the program that you are using. This will make you a registered
  53.    user of the software and entitle you to one free update of the
  54.    software plus notification of later updates.
  55.    
  56.    This software is freely distributable by any means as long as the
  57.    following conditions are adhered to:
  58.  
  59.    1. All of the files must be included in their original form without
  60.       additions, deletions or modifications of any kind.
  61.  
  62.    2. This software may not be sold or rented or hired without my
  63.       consent, given in writing.
  64.  
  65.    3. All copyright notices must remain intact.
  66.  
  67.    4. This software must not appear on any electronic service that
  68.       claims copyright to uploaded programs, either alone or as part of
  69.       a collection. 
  70.  
  71.    5. This software must also not appear on any magazine disk or similar
  72.       for mass distribution for profit without prior agreement by
  73.       myself.
  74.  
  75.    6. This software may be distributed free of charge provided that no
  76.       extra restrictions are placed on it. Nominal charges for copying
  77.       or on line services are permitted provided that they are only for
  78.       those services.
  79.  
  80.  
  81.    DISCLAIMER
  82.  
  83.    You use this software entirely at your own risk. No warranties are
  84.    expressed or implied. No responsibility is accepted for any damage
  85.    done to software or hardware during its use.
  86.  
  87.  
  88.  
  89.       MAIN WINDOW BUTTONS
  90.  
  91.  ß0ß        Close Window Button.
  92.             This button will close the window to which it is attached.
  93.             On the main screen it will exit the program.
  94.  
  95.  ß3ß        Help Button.
  96.             This button will display these help pages. Selecting
  97.             this button again will return to the main display.
  98.  
  99.  ß51ß       About Button.
  100.             Display information about this program.
  101.             
  102.              
  103.  ß15ß       Disk Window Button.
  104.             This button opens the disk access window for the opening
  105.             and closing of disk files.
  106.  
  107.  ß14ß       Hardware SetUp Button.
  108.             This button opens the hardware setup window
  109.             (not yet available).
  110.             
  111.  ß13ß       New Trace Button.
  112.             This button opens the New Trace window for the definition
  113.             of new traces.
  114.             
  115.  ß12ß       Trace Order Window Button.
  116.             This button opens the Trace Order Window for the opening,
  117.             closing and re-ordering of traces on the screen.
  118.  
  119.  ß11ß       Contract Horizontal Scale Button.
  120.             Display more samples per screen width.
  121.             
  122.  
  123.  ß10ß       Expand Horizontal Scale Button.
  124.             Display fewer samples per screen width.
  125.  
  126.  
  127.  ß9ß        Contract Vertical Scale Button.
  128.             Reduce the height of displayed traces. This allows more
  129.             traces to be visible on the screen at one time.
  130.             
  131.  ß8ß        Expand Vertical Scale Button.
  132.             Increase the height of displayed traces.
  133.  
  134.  
  135.  ß6ß        Trace/Text Display Button.
  136.             Toggle between trace and text display format.
  137.  
  138.  
  139.  ß5ß        Search Window Button.
  140.             This button opens the Search Window for locating and 
  141.             displaying specific patterns.
  142.  
  143.  ß4ß        Select Number Base Button.
  144.             This button toggles between decimal (base 10) or hexadecimal
  145.             (base 16) number representations.
  146.  
  147.  ß1ß        Print Screen Button.
  148.             This button prints the screen to the system printer
  149.             using the parameters set by Preferences. Printing may be
  150.             cancelled at any time by clicking on the button again.
  151.  
  152.  ß18ß ß19ß  The analyzer screen can be pushed and popped using these
  153.             buttons.
  154.             
  155.  
  156.       CURSOR FUNCTIONS
  157.  
  158.    There are three cursors available on the display: T,R and C. T
  159.    marks the trigger position when used with data acquisition hardware.
  160.    Without this, the T cursor is set permanently at 0. The other two
  161.    cursors R and C can be used to measure absolute position and relative
  162.    distance within the data.
  163.  
  164.    The cursors C and R may be moved through the data by the following
  165.    buttons: ß27ßß26ßß24ßß23ßß32ßß31ßß29ßß28ß respectively. Continuously
  166.    selecting these will accelerate the movement.
  167.  
  168.    The cursors C and R may be moved to the centre of the screen by the
  169.    ß25ßß30ß and to the start of the data file by the ß37ßß36ß buttons.
  170.  
  171.    The display may be centered on any of the cursors by use of the
  172.    ß34ßß35ßß33ß buttons.
  173.  
  174.  
  175.       FILE ACCESS WINDOW
  176.  
  177.    This window allows the opening and closing of data files. The only
  178.    limitation on the number of open files is the memory available. No
  179.    internal buffer is allocated for an open file until an element of
  180.    that file is displayed on the screen. Pattern searching (see later)
  181.    on an undisplayed file accesses the file on disk. The user can
  182.    therefore choose to trade performance against memory capacity.
  183.    
  184.    ß40ß     Open Disk Dile Button.
  185.             This button will open the file whose name appears in the
  186.             string gadget. When a file is successfully opened, the
  187.             traces that are initially displayed depend on the setting of
  188.             the automatic trace generation variable in the Trace Setup
  189.             Window.
  190.             
  191.    ß41ß     Close Disk File Button.
  192.             This button will close the file whose name appears in the
  193.             string gadget. Files may only be closed if no trace
  194.             (active or inactive) exists which is linked to this file.
  195.             
  196.    ß0ß      Close Disk Window Button.
  197.             This button closes the disk window. The current state of
  198.             variables in the window is preserved when the window is
  199.             reopened.
  200.             
  201.    The open file list may be scrolled using ß38ßand ß39ß.
  202.    
  203.    
  204.       TRACE SETUP WINDOW
  205.       
  206.    This window allows the characteristics of each new trace to be
  207.    determined. New traces may be generated individually from an already
  208.    open file, or automatically when a file is first opened.
  209.    
  210.    To generate an individual trace, it is necessary to select a source
  211.    file from the list of open files on the left (this may be done by
  212.    clicking on a name with the left mouse button or by typing directly
  213.    into the left hand string gadget), entering a name for the trace
  214.    in the right hand string gadget and specifying which bits of the
  215.    file should be included in the trace.
  216.    
  217.    Automatic trace generation may be enabled or disabled by clicking
  218.    on the top left bar. The type of trace generation may be cycled
  219.    by clicking on the top right bar in the window. The default is 
  220.    automatic trace generation ON, with each bit of the file displayed
  221.    individually.
  222.  
  223.    The buttons in the window have the following function:
  224.    
  225.    ß0ß      Close Window Button. 
  226.             This button closes the window. It will not operate if an 
  227.             error condition is present.
  228.             
  229.    ß45ß     New Trace Button
  230.             This button generates a new trace. If all conditions are not
  231.             correctly set, the error button  ß44ßwill light. The panel
  232.             will freeze until this button is selected.
  233.             
  234.    ß46ß     Reset Button.
  235.             This button resets all the parameters in the window.
  236.             
  237.             
  238.             
  239.    The individual bits which make up a trace are selected by clicking
  240.    on the  ß42ßbuttons. The trace width may be from 1 to 8 bits and may
  241.    start and end at any bit. The selected bits MUST BE CONTIGUOUS.
  242.    
  243.    The colour of the trace is determined by which of the colour select
  244.    buttons is pressed.
  245.  
  246.  
  247.  
  248.       TRACE ORDER WINDOW
  249.  
  250.    With this window it is possible to change the order in which the
  251.    traces are displayed on the screen. The traces are shown in a list
  252.    which represents the order in which they are displayed.
  253.    
  254.    Active traces are shown in green, inactive traces in red.
  255.    
  256.    If too many traces exist to be displayed in the window, the list may
  257.    be scrolled by the ß47ß  and ß48ß  buttons.
  258.    
  259.    
  260.    
  261.    To exchange two traces, first click the left mouse button over one
  262.    of the traces, and then click over the second. The traces will be
  263.    exchanged.
  264.    
  265.    To move a trace, first click on the trace to be moved, and then
  266.    click on the position where the trace should be inserted (in the 
  267.    gap between two trace boxes). The trace will be moved.
  268.    
  269.    If the mouse is clicked over the "X" part of the trace, that trace
  270.    will be deleted from the list.
  271.    
  272.    Traces may also be closed and deleted by clicking on the trace names
  273.    in the main window: "X" to delete, name to close.
  274.  
  275.  
  276.       SEARCH WINDOW
  277.  
  278.    The search window allows specific patterns to be serached for and
  279.    displayed across all the open data files. The search pattern may be
  280.    set by selecting the desired value for each bit of each open file
  281.    by clicking the left hand mouse button on each bit to select the 
  282.    search pattern for each file.
  283.    
  284.    One file may be set to completely to either '0', '1', or "don't care"
  285.    ('X') by clicking on the appropriate symbol on the right hand side
  286.    of the window.
  287.    
  288.    Searching may be done by either the R or C cursors by clicking on
  289.    the ß49ß  or ß50ß  buttons respectively.
  290.    
  291.  
  292.    The search will start immediately after the current position of the
  293.    selected cursor and will continue until the next match is found.
  294.    The button remains pressed while the search is in progress. 
  295.  
  296.    If the data files are long, or if some of the files being searched 
  297.    reside on disk only, a noticeable delay will occur during the search.
  298.  
  299.  
  300.  
  301.       MEMORY REQUIREMENTS
  302.       
  303.    This program can be run on a standard Amiga. Memory is not required
  304.    for an opened file until a component of that file is added to the
  305.    display list.
  306.  
  307.  
  308.       LIMITATIONS
  309.  
  310.    It is not currently possible to display on the screen a trace whose
  311.    source file will not fit completely into memory.       
  312.  
  313.  
  314.       BUGS
  315.       
  316.    I would welcome information about bugs found with this software,
  317.    and also any suggestions for improvements.
  318. TLSNA
  319.